SetupL1L2L3Post-L3Cross-frameworkKey OutputsEnd-to-End
🏗️
stage0 New Framework Setup
Setup

Run New_Framework_Setup_Agent.md — creates folder structure, copies CLAUDE.md template, scaffolds all required subfolders, creates ProjectStatus.md, appends ENGINE_CHANGELOG entry. Takes approximately 10 minutes.

  • Prompts/L1/setup/New_Framework_Setup_Agent.md
  • CLAUDE.md — Framework-specific context file (from template)
  • ProjectStatus.md — Pre-populated status tracker
  • L1/Background/L1_Decisions_Log.md — Blank decisions log template
  • ENGINE_CHANGELOG.md entry — New framework creation logged
👤 Facilitator: populate Framework Variables; confirm CLAUDE.md is complete
📋
stage1 L1 Pre-Work — Six Agents
L1

Run six pre-work agents in sequence to produce the seven workshop deliverables. Each agent output is reviewed by the facilitator before use. The Agent Primer is the only item sent to participants before the workshop (2–3 days prior).

  • Prompts/L1/agents/Industry_Research_Agent.md
  • Prompts/L1/agents/Industry_Standards_Mapper.md
  • Prompts/L1/agents/Competing_Frameworks_Agent.md
  • Prompts/L1/agents/Candidate_L1_Generator_Agent.md
  • Prompts/L1/agents/L1_Framing_Deck_Agent.md
  • Prompts/L1/agents/Agent_Primer_generation_prompt.md
  • Industry_Research_Pack.md — Market and sector research
  • Regulatory_Landscape_Profile.md — Regulatory and liability landscape
  • Competing_Frameworks_Table.md — Competitor and analogous framework comparison
  • Candidate_VSM.md + <frameworkSlug>_L1_Candidate_VSM.pptx — Candidate value stream map
  • L1_Framing_Deck.md + <frameworkSlug>_L1_Framing.pptx — Workshop framing presentation
  • Agent_Primer.md + <frameworkSlug>_L1_Agent_Primer.pptx — Participant pre-reading (send 2–3 days before)
  • L1_Decisions_Log.md — Pre-populated with participants and date
👤 Facilitator review: all seven deliverables reviewed and approved for workshop use
stage2 Workshop Readiness Gate
L1

Complete the 11-item readiness checklist from L1_design_framework.md Section 6 before the main workshop sessions can proceed. All pre-work deliverables must be complete and facilitator-reviewed, and a settling-in session (Phase 2.5, sponsors/leads only) must have been held — new as of 2026/08, to give sponsors/leads time to get into the right decision-making head space ahead of the wider workshop. Participants must have confirmed attendance and received the Agent Primer.

  • Prompts/L1/L1_design_framework.md
  • Readiness checklist (11 items) — All items signed off, including the settling-in session
👤 Gate: all 11 checklist items satisfied — workshop sessions may proceed
🎯
stage3 L1 Workshop Sessions
L1

2026/08 update: runs as 3–4 sessions of 1.5–2 hours each, spread across separate days, rather than a single contact day — giving SME participants time to settle into agentic-framework thinking between sessions. Four blocks: Block 1 (condensed framing + industry review), Block 2 (foundational decisions part 1), Block 3 (HITL/autonomy decisions + agentic architecture sketch), Block 4 (open items and read-back). Drives the five foundational decisions: macro process architecture, primary orchestration unit, process classification (value stream / cross-cutting / enterprise), mandatory human oversight requirements, and near-term vs. target autonomy levels. Process Recorder captures all decisions live in one continuous Decisions Log across all four blocks.

  • Prompts/L1/L1_Workshop_Dry_Run.md
  • Prompts/L1/templates/L1_Decisions_Log_template.md
  • L1_Decisions_Log.md — Live decisions capture throughout the day
  • Agreed L1 macro process map — Gate-to-gate sequence signed off by participants
👤 End of Block 4: all foundational decisions captured; open items logged with owners
📦
stage4 Post-Workshop and L2 Handoff
L1

Package workshop outputs, finalise the decisions log (all open items resolved or deferred with owner and deadline), produce the L1 Workshop Summary Deck, and confirm the L2 handoff artefact set is complete. Do not begin L2 pre-work until the decisions log is finalised.

  • Prompts/L1/L1_Workshop_Dry_Run.md
  • Prompts/L1/L1_design_framework.md
  • L1_Decisions_Log.md — Final — all decisions resolved
  • L1 Workshop Summary Deck — <frameworkSlug>_L1_Summary.pptx — Distributed to all participants
  • Agentic Architecture Overview v0.1 — Draft — updated through L2/L3
  • Open items register — All items resolved or deferred with owner
👤 L2 handoff gate: decisions log final; no unresolved open items; summary deck distributed
🔧
stage5 L2 Design (per macro process)
L2

Run L2_process_design_agent.md for each macro process to produce the sub-process architecture: 4–10 sub-processes with full SIPOC for both Interim and Target states, agent/human role assignments, HITL counts. Mandatory 3-step gate sequence before any PPTX is committed.

  • Prompts/L2/L2_process_design_agent.md
  • Prompts/L2/L2_design_framework.md
  • Prompts/L2/validate_l2_json.js
  • Prompts/L2/generate_l2_pptx.js
  • Prompts/L2/validate_l2_pptx.py
  • [MP]_L2_sub_process_design.md — 15-section L2 document
  • [MP]_L2_data.json — Structured data for PPTX generation
  • [MP]_L2_Architecture.pptx — Validated PPTX
👤 Pipeline gate: validate_l2_json.js PASS → generate → validate_l2_pptx.py PASS
👥
stage6 L2 Review and Approval
L2

Review workshop: distribute draft L2 document and PPTX at least 48 hours before. Facilitate review session with domain experts and stakeholders. Capture corrections and decisions. Revise document post-session. Version increment required before use as L3 input.

  • Prompts/L2/L2_design_framework.md
  • [MP]_L2_sub_process_design.md — Revised and approved (version incremented)
  • [MP]_L2_Architecture.pptx — Regenerated from approved JSON
👤 Gate: all corrections incorporated; version incremented; no open items
🔬
stage7 L3 Design (per sub-process)
L3

Run L3_process_design_agent_V3.md for each sub-process. Produces step-level design with swimlane diagrams, agent system prompts, signal architecture, HITL register for both states. Session split protocol: if ≥5 sub-processes expected, plan separate sessions. Four-validator sequence mandatory. Six output files per sub-process.

  • Prompts/L3/L3_process_design_agent_V3.md
  • Prompts/L3/L3_state_design_framework.md
  • Prompts/L3/generate_l3_html.js
  • Prompts/L3/validate_l3_html.js
  • Prompts/L3/generate_l3_pptx.js
  • Prompts/L3/validate_l3_pptx.py
  • Prompts/L3/generate_l3_docx.js
  • [MP].[N]_L3_process_design.md — Step-level L3 markdown
  • [MP].[N]_L3_data.json — Structured data for generators
  • [MP].[N]_Swimlane.html — Swimlane diagram (validated)
  • [MP].[N]_Swimlane.pptx — PPTX export
  • [MP].[N]_L3_process_design.docx — Word export via generate_l3_docx.js
  • [MP].[N]_HITL_Register.md — HITL register for both states
👤 Per sub-process: validate_l3_html.js PASS and validate_l3_pptx.py PASS
🤖
stage8 Post-L3 Agent Architecture (Artefacts A–H)
Post-L3

After all L3 sub-processes for a macro process are complete, run L2_post_L3_agent_architecture_design.md to produce the eight architecture artefacts. Artefact E (interaction diagrams) uses the generate_interaction_diagrams.js script with 23-check validator. All E files use the 04_ file prefix distinguished by AGENTCODE.

  • Prompts/L2/L2_post_L3_agent_architecture_design.md
  • Prompts/Agent/Agent_design_framework.md
  • Prompts/Agent/generate_interaction_diagrams.js
  • Prompts/Agent/validate_interaction_diagrams.js
  • 01_[MP]_Agent_Taxonomy.md — Artefact A — canonical agent taxonomy
  • 02_[MP]_Agent_Master_Catalogue.md — Artefact B — detailed agent specifications
  • 03_[MP]_Agentic_Architecture_Overview.md — Artefact C — architecture narrative
  • 04_[MP]_[AGENTCODE]_Interaction_Diagrams.html (×N) — Artefact E — per-agent interaction diagrams
  • 05_[MP]_Coverage_Matrix.md — Artefact F — cross-sub-process agent coverage
  • 06_Agent_Interaction_Diagrams.html — Artefact G — combined diagrams
  • 07_HITL_Master_Register.md — Artefact H — consolidated HITL register
👤 Gate: validate_interaction_diagrams.js PASS (V01–V23); all 8 artefacts present
🔄
stage9 L2 Consistency Review
Post-L3

After artefacts A–H are complete, run L2_post_L3_update_L2_outputs.md to reconcile L2 documents with the finalised agent architecture. Three-step process: prepare agent materials → conduct review session → apply updates. Mandatory trigger: if L3 work revealed any agent changes, SIPOC updates, or new HITL gates not in the L2 document.

  • Prompts/L2/L2_post_L3_update_L2_outputs.md
  • [MP]_L2_sub_process_design.md — Updated (version incremented)
  • [MP]_L2_Architecture.pptx — Regenerated from updated JSON
👤 Gate: L2 document reflects all post-L3 changes; PPTX regenerated and validated
🌐
stage10 Cross-Framework Synthesis and Normalisation
Cross-framework

Update the Framework Agent Register (FAR) to reflect the completed macro process. Update or confirm the L1 Agentic Architecture Overview once sufficient macro processes are complete. Review agent naming, tier classification, and HITL criteria for consistency across macro processes. Normalise any divergences before proceeding.

  • Prompts/L1/agents/Framework_Agent_Register_Agent.md
  • Prompts/L1/agents/L1_Agentic_Architecture_Overview_Agent.md
  • [FRAMEWORK_ID]_Framework_Agent_Register.md — FAR updated for this macro process
  • [FRAMEWORK_ID]_L1_Agentic_Architecture_Overview.md — Updated (provisional or confirmed)
👤 Gate: FAR updated; agent naming and tier classification consistent across completed macro processes
📊
stage11 Key Outputs — Process Hierarchy, Infographic, Explorer
Key Outputs

Produce three cross-framework summary deliverables. Each has a mandatory gate sequence. Run when all macro processes for the framework are complete (or at agreed milestones). Explorer has internal and client modes — never distribute internal builds externally.

  • Prompts/L1/FullProcessExport.md
  • Prompts/L1/ProcessHierarchyGenerator.md
  • Prompts/Infographic/Infographic_Agent.md
  • Prompts/Infographic/generate_infographic_html.py
  • Prompts/Infographic/generate_infographic_pptx.js
  • Prompts/Infographic/generate_infographic_pdf.py
  • Prompts/Explorer/Explorer_generation_agent.md
  • Prompts/Explorer/build_explorer_manifest.py
  • Prompts/Explorer/generate_explorer_html.py
  • Prompts/Explorer/validate_explorer_html.py
  • [SLUG] — Full Process Register.xlsx — All L1/L2/L3 processes
  • [SLUG] — Process Hierarchy.html + .pptx — Interactive hierarchy view
  • Infographics/ — HTML + PPTX + PDF — Framework summary infographic
  • [FRAMEWORK_NAME] — Explorer.html — Single-file framework Explorer (internal build)
  • [FRAMEWORK_NAME] — Explorer (Client).html — Client-safe Explorer build
👤 Explorer gate: validate_explorer_html.py PASS; Infographic gate: validate_raise_docx.py PASS
⚙️
stage12 RAISE Configuration
Key Outputs

Run RAISE_generation_agent.md to produce the RAISE platform configuration document. Four-step gate sequence: generate JSON → validate JSON → generate DOCX → validate DOCX. Maps all agents, sub-processes, and HITL patterns from the framework's L2/L3 designs onto the RAISE Agent Builder palette.

  • Prompts/RAISE/RAISE_generation_agent.md
  • Prompts/RAISE/validate_raise_json.js
  • Prompts/RAISE/generate_raise_docx.py
  • Prompts/RAISE/validate_raise_docx.py
  • [slug]_RAISE_data.json — Intermediate structured data
  • [slug]_RAISE_document.docx — RAISE platform configuration document
👤 Gate: validate_raise_json.js PASS then validate_raise_docx.py PASS
🎛️
stage13 Control Plane Architecture
Key Outputs

Produce the framework-level Control Plane Architecture document. This is a cross-process, framework-level document covering the persistent operational layer — five layers (Config, Signal, State, Intelligence, Governance) — that integrates humans, agents, process, data, and outcomes. Can begin alongside L1/L2 design; confirmed after all macro processes complete.

  • Prompts/ControlPlane/AIF_ControlPlane_design_framework.md
  • [FRAMEWORK_ID]_ControlPlane_Architecture.md — Five-layer Control Plane design for the vertical
👤 Gate: all five layers specified; business-facing name established; output in ControlPlane/ folder
🔍
stage14 End-to-End Review
End-to-End

Cross-cutting review of the complete framework with key stakeholders. Three-step: (1) prepare a review pack covering the full L1/L2/L3 design, the Explorer, the Infographic, and the FAR; (2) conduct the review session with the client/domain sponsor; (3) resolve any final corrections and update the relevant documents. Trigger: all macro processes complete or substantially complete.

  • Review pack — Explorer + Infographic + FAR summary
  • Corrections log — Post-review corrections applied to relevant documents
👤 Gate: all corrections applied; sponsor sign-off confirmed
🏁
stage15 Framework Complete Gate
End-to-End

Final gate confirming the framework is complete and all deliverables are in place. Update ProjectStatus.md to mark the framework as complete. All L2 and L3 designs signed off; Explorer, Infographic, and RAISE outputs validated; HITL Master Registers complete for all macro processes; FAR and L1 Agentic Architecture Overview confirmed.

  • ProjectStatus.md — Updated to Framework Complete status
👤 Final gate: all criteria satisfied; ProjectStatus.md updated; framework ready for use